ïQuickDraw GX PrintingContents Figures, Tables, and ListingsAbout This BookFormat of a Typical Chapter Conventions Used in this Book
Special FontsTypes of Notes
Empty StringsThe Development EnvironmentFor More Information*Introduction to Printing with QuickDraw GX About Printing With QuickDraw GXCore Printing FeaturesGFigure 1-1 Dragging a document to a desktop printer icon on the desktop*Customizing QuickDraw GX Printing Features:Figure 1-2 Printing a document containing multiple formatsAdvanced Printing FeaturesAFigure 1-3 Printing the pages of a document on different printers@Figure 1-4 A user-defined paper type printed on letterhead paper1QuickDraw GX Print Objects and Collection Objects<Figure 1-5 QuickDraw GX print objects and collection objects0Job Object, Format Object, and Paper Type Object<Job Collection, Format Collection, and Paper Type CollectionManipulating Print ObjectsBFigure 1-6 Manipulating the job object in response to user actionsMessages and Printing.Figure 1-7 Message handlers in a message chain1Figure 1-8 Overriding the GXPrintingEvent message Printing and the User InterfaceQuickDraw GX Menu Commands2Figure 1-9 Printing menu commands in the File menu'QuickDraw GX Movable Modal Dialog BoxesDesktop Printers6Figure 1-10 Default QuickDraw GX desktop printer icons8Figure 1-11 The desktop printer window for a LaserWriter8From Macintosh Printing Manager to QuickDraw GX PrintingPrinter Drivers!System Printer to Default Printer Print Record to Print Object'Spool File to Portable Digital DocumentCore Printing Features About Core Printing Features Using Core Printing FeaturesBasic Print ObjectsThe Job ObjectFigure 2-1 The job objectThe Format Object Figure 2-2 The format objectThe Paper Type Object Figure 2-3 The paper type object$Preparing to Print With QuickDraw GX;Determining and Initializing QuickDraw GX Printing Features Using Error Handling Methods9Listing 2-1 Polling for errors after individual functions8Listing 2-2 Polling for errors after groups of functions2Supporting QuickDraw GX Movable Modal Dialog BoxescListing 2-3 Using the GXInstallApplicationOverride function to override the GXPrintingEvent message.Creating a Job Object for a Printable Document:Listing 2-4 Creating a job object for a printable document%Printing Documents Using QuickDraw GX Printing Pages as Single Shapes>Listing 2-5 Printing a document using the GXPrintPage function"Printing Pages by Capturing Shapes^Listing 2-6 Printing a document using the GXStartPage, GXDrawShape, and GXFinishPage functions(Saving A Job Object With a Document File&Saving a Job Object in a Single HandleEListing 2-7 Using the GXFlattenJobToHdl function to save a job object/Saving a Job Object Using a Flattening Function@Listing 2-8 Using the GXFlattenJob function to save a job object1Disposing of a Job Object When Closing a Document?Listing 2-9 Disposing of a job object when you close a document/Retrieving a Job Object When Opening a Document%Retrieving a Job Object From a HandleNListing 2-10 Using the GXUnflattenJobFromHdl function to retrieve a job object6Retrieving a Job Object Using an Unflattening FunctionGListing 2-11 Using the GXUnflattenJob function to retrieve a job object(Obtaining Information on a Format ObjectEListing 2-12 Using the GXGetFormatJob function to obtain a job object\Listing 2-13 Using the GXGetFormatDimensions function to obtain a format object’s dimensions2Displaying QuickDraw GX Movable Modal Dialog Boxes(Displaying the Document Setup Dialog Box(Figure 2-4 The Document Setup dialog box1Figure 2-5 The expanded Document Setup dialog box5Listing 2-14 Displaying the Document Setup dialog box Displaying the Print Dialog Box Figure 2-6 The Print dialog box(Figure 2-7 The expanded Print dialog box-Listing 2-15 Displaying the Print dialog box #Supporting Printing From the Finder[Listing 2-16 Responding to the Print Documents Apple event and specifying an output printer#Printing Non-QuickDraw GX Documents8Listing 2-17 Converting a print record into a job object Core Printing Features ReferenceData Types and Constants Gestalt Selector for PrintingQuickDraw GX Print ObjectsEdit Menu LocationDialog Box Results Functions.Initializing and Terminating Printing FeaturesGXInitPrintingGXExitPrintingHandling Errors
GXGetJobError
GXSetJobError!Creating and Managing Job ObjectsGXNewJob GXDisposeJobGXFlattenJobToHdl GXFlattenJobGXUnflattenJobFromHdlGXUnflattenJobPrinting Using QuickDraw GXGXSelectJobOutputPrinterGXGetJobPageRange
GXStartJob GXPrintPage GXFinishJob GXStartPage GXFinishPage&Obtaining Information on Print ObjectsGXGetJobFormatGXGetFormatJobGXGetFormatDimensions4Displaying the Document Setup and Print Dialog Boxes GXInstallApplicationOverrideGXPrintingEvent messageGXJobDefaultFormatDialogGXJobPrintDialogConverting a Print RecordGXConvertPrintRecord Application-Defined FunctionsFlattening a Job ObjectUnflattening a Job Object!Summary of Core Printing Features,Page Formatting and Dialog Box Customization2About Page Formatting and Dialog Box CustomizationCollection ObjectsThe Job Collection Figure 3-1 The job collectionThe Format Collection Figure 3-2 The format collectionThe Paper Type Collection$Figure 3-3 The paper type collectionPage FormattingRFigure 3-4 A three page document, its corresponding job object, and format objectsManipulating Format ObjectsEFigure 3-5 Manipulating the format object in response to user actionsMapping for Format ObjectsForms and Format Objects.Figure 3-6 A database application using a form!Halftoning and Format CollectionsDialog Box Customization<Figure 3-7 The expanded Print dialog box with an added panelDefault Dialog Box Panels Figure 3-8 The Print Time panelFigure 3-9 The Paper panel Figure 3-10 The Scaling panel Messages and Dialog Box Panels3Figure 3-11 Overriding the GXJobPrintDialog messageUsing Collection Objects"Adding Data to a Collection Object Accessing Collection ObjectsCListing 3-1 Accessing copies information stored in a job collectionUsing Format Objects2Choosing and Formatting Multiple Pages at One Time?Listing 3-2 Selecting and formatting multiple pages at one time&Tracking a Format Object’s Owner Count1Creating a Format Object for a Page in a DocumentNFigure 3-12 A four page document in which page two uses a unique format object=Listing 3-3 Creating a format object for a page in a document/Cloning a Format Object For Pages in a DocumentXFigure 3-13 A four page document in which pages two and three use the same format object?Listing 3-4 Cloning a format object for two pages in a document5Disposing of a Format Object for a Page in a DocumentXFigure 3-14 A four page document in which pages two and three use unique formats objectsXListing 3-5 Disposing of a format object for a page in a document and creating a new one+Listing 3-6 Reverting to the default format5Listing 3-7 Reassociating a page with a format object'Displaying the By Page Setup Dialog Box(Figure 3-15 The By Page Setup dialog box1Figure 3-16 The expanded By Page Setup dialog box0Listing 3-8 Supporting QuickDraw GX dialog boxes4Listing 3-9 Displaying the By Page Setup dialog box -Using Objects for Special Formatting Features Using Forms With Format Objects-Listing 3-10 Adding a form to a format object3Storing Halftone Information in a Format Collection@Listing 3-11 Storing halftone information in a format collection2Copying a Format Object For Use in Other Documents?Figure 3-17 Moving a format object from one document to another@Listing 3-12 Moving a format object from one document to another0Accessing Information on Specific Format Objects#Obtaining a Format Object’s Mapping0Listing 3-13 Obtaining a format object’s mapping-Obtaining a Format Object’s Paper Type ObjectkFigure 3-18 A three-page document and its corresponding job object, formats objects, and paper type objects:Listing 3-14 Obtaining a format object’s paper type object,Scanning Through a Document’s Format Objects@Listing 3-15 Obtaining scaling information on each format object.Associating Format Objects With Document PagesXListing 3-16 Saving format object to document page correspondence in a format collection^Listing 3-17 Retrieving format object to document page correspondence from a format collection%Customizing QuickDraw GX Dialog Boxes Adding Panels to Dialog Boxes*Listing 3-18 Adding panels to dialog boxes Automating Panel Information3Listing 3-19 An 'xdtl' resource definition template Listing 3-20 The 'DITL' resource*Listing 3-21 The Additions 'xdtl' resource.Listing 3-22 The AdditionsCollection structure6Listing 3-23 Sample menu definition for pop-up control8Page Formatting and Dialog Boxes Customization ReferenceData Types and Constants*Loop Status Information For Format Objects Collection Object Tag CategoriesCollection Object Tag ID-Job Collection Item for Print Job Information-Job Collection Item for Collation Information(Job Collection Item for Copy Information.Job Collection Item for Page Range Information+Job Collection Item for Quality Information4Job Collection Item for File Destination Information1Job Collection Item for File Location Information/Job Collection Item for File Format Information.Job Collection Item for File Fonts Information.Job Collection Item for Paper Feed Information-Job Collection Item for Tray Feed Information/Job Collection Item for Manual Feed Information4Job Collection Item for Standard Mapping Information3Job Collection Item for Special Mapping Information/Job Collection Item for Bin Mapping Information#Job Collection Item for {to define}/Job Collection Item for Print Panel Information0Job Collection Item for Format Panel Information+Format Collection Item for Lock Information.Format Collection Item Orientation Information*Format Collection Item Scaling Information.Format Collection Item Direct Mode Information2Format Collection Item Special Mapping Information5Format Collection Item for Page Inversion Information;Format Collection Item for Page Flip Horizontal Information9Format Collection Item for Page Flip Vertical Information5Format Collection Item for Precise Bitmap Information/Paper Type Collection Item for Base Information2Paper Type Collection Item for Creator Information0Paper Type Collection Item for Units Information0Paper Type Collection Item for Flags Information2Paper Type Collection Item for Comment Information)QuickDraw GX Dialog Box Panel Information Functions(Creating and Manipulating Format Objects GXNewFormatGXDisposeFormat GXCopyFormat
GXCloneFormatGXCountJobFormatsGXCountFormatOwnersGXForEachJobFormatDo%Manipulating Format Object PropertiesGXGetFormatMappingGXGetFormatPaperTypeGXGetFormatFormGXSetFormatFormGXChangedFormat'Displaying the By Page Setup Dialog BoxGXFormatDialog%Customizing QuickDraw GX Dialog Boxes GXInstallApplicationOverrideGXJobPrintDialog message GXJobDefaultFormatDialog messageGXFormatDialog messageGXHandlePanelEvent messageGXFilterPanelEvent messageGXSetupDialogPanelGXGetJobPanelDimensionsGXEnableJobScalingPanel Accessing Collection ObjectsGXGetJobCollectionGXGetFormatCollectionGXGetPaperTypeCollection Application-Defined Functions Looping Through Format Objects ResourcesThe Panel ('panl') Resource The User Alert ('cool') Resource#Figure 3-19 The cool alert resource(Table 3-1 Cool alert versions(continued)3Table 3-2 Cool alert icon IDs(continued)(continued)<Table 3-3 Cool alert default button string values(continued);Table 3-4 Cool alert cancel button string values(continued)7Summary of Page Formatting and Dialog Box CustomizationAdvanced Printing Features About Advanced Printing Features&Printer Objects and Print File ObjectsPrinter Objects Figure 4-1 The printer objectPrint File Objects Figure 4-2 The print file object*Multiple Job Objects for a Single DocumentMore About MessagesOutput Optimization Direct ModeSynonyms Using Advanced Printing Features#Using Advanced Job Object Functions@Obtaining Printer and Printer Driver Information on a Job ObjectQListing 4-1 Obtaining the names and creator types of a printer and printer driver:Listing 4-2 The 'DLOG' and 'DITL' resources for the dialog<Retrieving and Setting a Reference Constant for a Job ObjectQListing 4-3 Storing and retrieving data using the job object’s reference constant Copying Job Object Information*Listing 4-4 Copying job object information Updating Job Object Information7Listing 4-5 Updating a job when receiving resume events Working With Printer Objects"Obtaining Printer Objects and Jobs6Retrieving and Counting a Printer Object’s ViewDevicesDObtaining Printer and Printer Driver Information on a Printer Object Manipulating Print File Objects Defining the Print File Object'Opening and Closing a Print File Object3Listing 4-6 Opening and closing a print file objectSaving a Print File Object*Obtaining a Print File Object’s Job Object Viewing Print File Object Data'Listing 4-7 Reading a print file object)Counting the Pages in a Print File Object*Adding or Deleting Print File Object Pages Defining Different Paper Sizes*Creating and Disposing A Paper Type Object,Listing 4-8 Creating a new paper type object"Obtaining and Counting Paper Types'Replacing Paper Type Object Information'Obtaining Paper Type Object Information0Listing 4-9 Obtaining a paper type object’s nameHListing 4-10 Obtaining page and paper rectangles for a paper type object6Scanning Paper Types Objects Available to a Job Object-Listing 4-11 Calling a paper type’s procedure*Working With Status Dialog Box Information*Optimizing Your Output on Specific DevicesUsing Direct ModeUsing SynonymsVector Devices and synonyms#Optimizing Output on Vector Devices$Advanced Printing Features ReferenceData Types and ConstantsBLoop Status Information For Paper Type Objects and Printer ObjectsJob Object Direct Modes Status Dialog Box Information%Paper Type Object Mapping Information)Paper Type Object View Device Tag ObjectsSynonym Information Functions*Working With Advanced Job Object Functions GXSelectJobFormattingPrinterGXGetJobFormattingPrinterGXGetJobOutputPrinterGXGetJobRefConGXSetJobRefCon GXCopyJob GXUpdateJob Manipulating Printer ObjectsGXGetJobPrinterGXGetPrinterJob GXForEachPrinterViewDeviceDoGXCountPrinterViewDevicesGXGetPrinterViewDeviceGXSelectPrinterViewDeviceGXGetPrinterDriverNameGXGetPrinterNameGXGetPrinterDriverTypeGXGetPrinterType,Working With QuickDraw GX Print File ObjectsGXOpenPrintFileGXClosePrintFileGXGetPrintFileJobGXCountPrintFilePagesGXReadPrintFilePageGXReplacePrintFilePageGXInsertPrintFilePageGXDeletePrintFilePageRangeGXSavePrintFileWorking With Paper TypesGXNewPaperTypeGXDisposePaperTypeGXGetNewPaperTypeGXGetJobPaperTypeGXCountJobPaperTypesGXCopyPaperTypeGXGetPaperTypeNameGXGetPaperTypeDimensionsGXGetPaperTypeJobGXForEachJobPaperTypeDo Formatting for Specific Devices GXSetAvailableJobFormatModesGXGetPreferredJobFormatModeGXGetJobFormatModeGXSetJobFormatModeGXJobFormatModeQuery Application-Defined Functions%Summary of Advanced Printing FeaturesGlossaryIndex
